home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / x11 / strategy / imaze1.3 / imaze1 / imaze / README next >
Text File  |  1996-02-22  |  10KB  |  321 lines

  1.  
  2.  
  3.                           iMaze - version 1.3
  4.                              February 1996
  5.  
  6.                           by Hans-Ulrich Kiel
  7.                           and Joerg Czeranski
  8.                             at TU Clausthal
  9.  
  10.  
  11.                        join the iMaze community
  12.                              and have fun!
  13.  
  14.  
  15.  
  16. Copyright
  17. =========
  18.  
  19. Copyright (c) 1993-1996 by Hans-Ulrich Kiel and Joerg Czeranski
  20.  
  21. Permission is granted to any individual or institution to use or copy
  22. iMaze so long that it is not sold for profit and that this copyright
  23. notice is retained. The source code of iMaze may ONLY be distributed
  24. in its original, unmodified state.
  25.  
  26. Contributions and enhancements to iMaze will be appreciated,
  27. and should be sent to us.
  28.  
  29.  
  30. What is iMaze?
  31. ==============
  32.  
  33. iMaze is a multi-player network action game for TCP/IP with 3D graphics
  34. under X11/XView and Motif.
  35.  
  36. It has successfully broken down the local FORTRAN lessons.
  37.  
  38. Other features include:
  39. - sophisticated, reliable network protocol, works even with SLIP connections
  40.   via modem
  41. - windows can be freely scaled to avoid speed drawbacks due to poor display
  42.   performance
  43. - modular, portable source code
  44. - scores
  45. - extensive documentation (german)
  46.  
  47. After hours of testing, dueling and enjoying MidiMaze 2 on the Atari ST we
  48. decided that it wouldn't be such a bad idea to write something similar for
  49. Unix. "iMaze" means "Internet Maze" and by a strange coincidence it is also
  50. a substring of "MidiMaze".
  51.  
  52. For those whom fate has denied the pleasures of MidiMaze we should add the
  53. following:
  54.  
  55. You run through a labyrinth and shoot everything that is round without being
  56. hit by other round anythings.
  57. Of course anything round is one of the following:
  58. - other players playing over the net
  59. - computer controlled ninjas
  60. - deadly shots (except your own)
  61.  
  62. We even managed to have this work be accepted as our "Softwarepraktikum"
  63. (some kind of term project every computer science student in Clausthal has
  64. to do).
  65.  
  66. If you wonder what Clausthal is: it is that little town just between Berlin
  67. and Bonn with no girls, bad weather, slow Internet connectivity and weird
  68. people willing to devote their time to stupid computer games.
  69.  
  70.  
  71. Supported systems
  72. =================
  73.  
  74. iMaze was tested successfully on the following systems:
  75.  
  76. SunOS 4.1.3, OpenWindows
  77. SunOS 5.5, OpenWindows
  78. SunOS 5.5, Motif
  79. Linux Slackware, OpenWindows
  80. Ultrix 4.4, Motif
  81. HP-UX 9.05, Motif
  82. DEC OSF/1 3.2C, Motif
  83. AIX 4.1.4, Motif
  84. FreeBSD 2.1, OpenWindows
  85. SGI Irix v5.3, Motif
  86. Sinix 5.41, Motif, GNU-make
  87.  
  88. You may be able to compile it with another OS, if you have the XView
  89. library or the Motif library.
  90.  
  91. It should run with any graphics hardware including black and white and
  92. grayscale X displays.
  93.  
  94. Sound is only implemented for Linux, FreeBSD and SunOS with OpenWindows
  95. and (analog) joystick support only for Linux and FreeBSD.
  96. The Linux joystick support was written for the joystick kernel module 0.7.3.
  97.  
  98.  
  99. What do you get?
  100. ================
  101.  
  102. If you don't have "imaze1.3.tar.Z" yet, get it now from
  103. ftp.tu-clausthal.de:/pub/unix/games/imaze (while this README waits for you).
  104.  
  105. Uncompress it and un-tar it, it will create the directory "imaze".
  106.  
  107. The directory "imaze" contains this README and a sample Xdefaults file.
  108. The directory "imaze/source" contains the sources and the Makefile.
  109. The directory "imaze/man6" contains the man pages.
  110. The directory "imaze/cat6" contains the cat-man pages.
  111. The directory "imaze/labs" contains some demo labyrinths.
  112.  
  113. Sound files and german documentation for version 1.0 (which HUK is very
  114. fond of) are also available on ftp.tu-clausthal.de but they're not included
  115. in "imaze1.3.tar.Z".
  116.  
  117.  
  118. How to compile?
  119. ===============
  120.  
  121. For OpenWindows systems $OPENWINHOME needs to be defined as /usr/openwin,
  122. /usr/local/openwin or wherever your OpenWindows stuff resides.
  123.  
  124. Then type "cd imaze/source".
  125.  
  126. You may want to define the default server host as:
  127. DEFINES=-DDEFAULT_SERVER='"host.name"' in the Makefile. Otherwise the
  128. default is to connect to the iMaze server in Clausthal.
  129.  
  130. If you use the sound, you may set the sound directory as:
  131. DEFINES=-DDEFAULT_SOUND_DIR='"/sound/dir"' in the Makefile.
  132.  
  133. Choose the appropriate definitions in the first section of the Makefile.
  134.  
  135. Type "make" to get an overview of the supported platforms.
  136. Then type "make <system>".
  137.  
  138.  
  139. How to start?
  140. =============
  141.  
  142. First start the server "imazesrv", then the clients "imaze"/"ninja".
  143. See the man pages for details.
  144.  
  145.  
  146. The rules of the game
  147. =====================
  148.  
  149. Aim:
  150. Run through the labyrinth and shoot the other players without being shot
  151. yourself.
  152.  
  153. Doors:
  154. Colored walls are doors. Some doors can be passed through in one direction
  155. only.
  156.  
  157. Shots:
  158. You can only shoot forward. If you shoot again, your previous shot dies.
  159. The shot dies also, if it hits a player, a wall or a door.
  160.  
  161. Death:
  162. After being shot, you are suspended from the game for 3 seconds and then
  163. join in again at a random place.
  164.  
  165. Score:
  166. You get 1 point for every shot enemy.
  167.  
  168.  
  169. How to use the user client?
  170. ===========================
  171.  
  172. The XView client has three buttons:
  173. "Open" opens a front view, a rear view, a map, a compass or a scores list.
  174. "Properties" opens a properties window. You may activate scrollbars for
  175.   the map there.
  176. "Connect/Disconnect" connects/disconnects your client to/from the server.
  177. "Pause/Resume" pauses/resumes the player.
  178.  
  179. The Motif client has four menus:
  180. "File" only contains an "Exit" item.
  181. "Window" is the same as the "Open" menu of the XView client.
  182. "Server" contains "Connect" and "Disconnect".
  183. "Game" allows pausing and resuming the player with the "Pause" and "Resume"
  184.   items.
  185.  
  186. After connecting to the server, the front view and scores windows (or
  187. whatever you configure in your ~/.Xdefaults file) open automatically.
  188.  
  189. For playing click on any of the client windows, so that it receives
  190. keyboard input.
  191.  
  192. The cursor keys move the player, the spacebar and the shift
  193. and alt keys are for shooting (remember: you have one shot only).
  194. With ^S you pause your player, with ^Q you resume.
  195.  
  196. The main window will display a 3D view. If you are not in the game, the
  197. main window is simply grey, if you have been shot, the lucky enemy and
  198. his message is displayed.
  199.  
  200.  
  201. How to create new labyrinths?
  202. =============================
  203.  
  204. You can create your own labyrinths with "genlab".
  205.  
  206. Typing "./genlab" gives you the possible arguments.
  207.  
  208. Just play around with it. But you should at least specify "-v" for verbose
  209. and "-s" for searching for a labyrinth without traps.
  210.  
  211. The values for -d and -D shouldn't be too high.
  212.  
  213.  
  214. How to create new sounds?
  215. =========================
  216.  
  217. The sound files use the Sun audio u-law 8000hz format. If you
  218. have a microphone, you can record new sounds with the SunOS
  219. audiotool.
  220.  
  221.  
  222. Known bugs
  223. ==========
  224.  
  225. Often the ninjas just don't have an idea where to move. Just give them a
  226. break, they're still kind of dumb. :-)
  227.  
  228. It is no bug, that you can't leave a one way door in the other direction,
  229. even if you have just touched it.
  230.  
  231.  
  232. Prior versions
  233. ==============
  234.  
  235. The version 1.0 was released in May 1994.
  236.  
  237. Solved bugs since 1.0:
  238. - the server produced zombie processes
  239. - the XView client complained about "embedding seal incorrect"
  240. - the XView client sometimes omitted walls in the 3D display
  241. - unused bits in the labyrinth files weren't set to zero by genlab
  242.  
  243. New features since 1.0:
  244. - compatibility with HP-UX, Ultrix and maybe AIX
  245. - logging of connections to the server
  246. - sound for the XView client on SunOS and Linux
  247. - joystick for the XView client on Linux
  248. - man pages
  249.  
  250. The version 1.1 was released in July 1994.
  251.  
  252. Solved bugs since 1.1:
  253. - problems with Solaris 2.x
  254. - some of the 3D bugs were fixed
  255.  
  256. New features since 1.1:
  257. - score
  258. - X resources
  259. - client doesn't terminate after disconnect,
  260.   you can reconnect to same or other server
  261. - 2 hours timeout for the ninja
  262. - a message is sent to players that you kill
  263.  
  264. The version 1.2 was released in December 1994.
  265.  
  266. Solved bugs since 1.2:
  267. - the server name was not configurable in the Makefile
  268. - sometimes the client kill message was scrambled in the 3D display
  269. - Linux sound didn't work properly
  270.  
  271. New features since 1.2:
  272. - Motif support
  273. - support for several new platforms
  274. - pause button
  275.  
  276.  
  277. Where to get iMaze from?
  278. ========================
  279.  
  280. The newest version is always available on ftp.tu-clausthal.de (139.174.2.10)
  281. in the directory /pub/unix/games/imaze. You can fetch it via anonymous ftp,
  282. fsp (port 21) or email to mail-server@ftp.tu-clausthal.de.
  283.  
  284.  
  285. Credits
  286. =======
  287.  
  288. Axel Buttchereit at the Institute for Computer Science of the TU Clausthal
  289.   for guiding the project until version 1.0
  290. Christian Perle at the TU Clausthal
  291.   for designing the title picture of the documentation with POVray
  292. Oliver Teuber at the FH Hannover
  293.   for implementing sound on Linux and arranging MidiMaze sessions
  294. Andreas Piefke at the TU Clausthal
  295.   for allowing us to test sound and joystick support on his Linux machine
  296. Gordon Berkley at Motorola Communications Israel Ltd., Tel Aviv
  297.   for HP patches
  298. Stefan Schwoon and Andre at the University of Hildesheim
  299.   for working on enhancements
  300. Ronald Kuehn at the TU Clausthal
  301.   for the FreeBSD support
  302. Ingo Macherius at the TU Clausthal
  303.   for the Sinix support
  304.  
  305. and all beta testers and people who sent us bug reports.
  306.  
  307.  
  308. How to contact us?
  309. ==================
  310.  
  311. The iMaze developers, Hans-Ulrich Kiel and Joerg Czeranski, can be reached
  312. via email as:
  313.  
  314. imaze@tu-clausthal.de
  315.  
  316. Or put anything intended for us as a single archive (e.g. tar) via
  317. anonymous ftp into /pub/unix/incoming on ftp.tu-clausthal.de.
  318.  
  319. There is also a WWW page available at
  320. http://www.tu-clausthal.de/student/iMaze/
  321.